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INTRODUCTION 


This manual contains instructions for using the CANSIM Interactive System 
(CIS), implemented in APLSV-OS-HASP environment. CIS provides access to Statistics 
Canada's Main Base. 


In the examples given, information entered by the user is underlined. Where a 
YES/NO type answer is requested, Y means YES and N means NO; the full words YES and 
NO are also acceptable. Some syntax checking is done when retrieval parameters are 
entered, but there is no guarantee that once the retrieval request is accepted, it 
will be successful. (For example, the matrix number requested may not exist.) For 
a more detailed description of the retrieval parameters, error messages, etc., consult 
the CANSIM Users' Manual for Data Retrieval and Manipulation (Catalogue Number 12-531), 
available from CANSIM, Current Economic Analysis Division, Statistics Canada, Ottawa. 
This Manual assumes a familiarity on the part of the reader with the CANSIM Summary 
Reference Index and CANSIM Main Base Series Directory. These are also available 
from the CANSIM Staff. 


CANSIM Main Base retrievals can be accomplished without knowledge of APL, the 
language in which the CANSIM Interactive program is written. Data manipulation, 
however, requires some familiarity with the language. More detailed information on 
APL may be obtained from the manual APL Language, IBM, GC26-3847-2, File No. 
$370-22.%* 


* Copies may be purchased from IBM. 


Note: 


EXAMPLE 
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CHAPTER 1 - GENERAL INFORMATION 


A. ACCESS CANSIM INTERACTIVE PROGRAM — 


You must obtain a CANSIM User Code to be an authorized user of the 
CANSIM Interactive System. To have your APL number authorized to access 
CANSIM, please contact the CANSIM staff at Statistics Canada. 


After signing on to APL, the following procedure must be used to gain access 
to the CANSIM Interactive program: 


1.) ) LOAD 601 CANSIM 
2. Saved 15219 14902 /i is 
3. ENGLISH/FRANCAIS? E/F? By 


The CANSIM Interactive program is stored in the APL Library 601. To access 
the program, use the APL system command JLOAD\) . 


After CANSIM has been loaded (line 1) CANSIM Interactive will automatically 
begin executing. Line 3 offers the user the option of accessing an English 
or French version of the program. 


Printed output from a CANSIM retrieval is formatted for a 130- character terminal. 
If the platen on your terminal is fewer than 130- characters wide, you may lose 
some print from the right hand end of each line. To avoid this, type: 


EXAMPLE 


Z 

1. )LOAD 601 CANSIMW 

2. Saved LOM a2 / L777. 

3. ENGLISH/FRANCAIS? E/F? E 
4, ENTER LINE WIDTH(50-130) 80 


The output will not be reformatted to center on a smaller platen. However, 


it will "wrap around“; that is, it will print as much of the line transmitted 
(for a 130- character terminal) as it can and then move to the next line on the 
page to finish the line transmitted. For samples of printouts, with the line 
width set to 80, see Appendices C and D. 


NOTE: 


At this point the user is informed of any messages that have been filed. 
There are two types of messages - individual and broadcast. Broadcast mes- 
sages can only be sent by CANSIM staff. They are printed automatically when 
a user signs on to CANSIM, and are deleted once they are printed. 


The user will also be informed if any Individual messages, that is messages 
that have been sent from other CIS users using the MES Command, are waiting. 
These messages are printed at the user's request and once printed they are 
deleted. When printed, each message is preceded by the date it was sent and 


the account number of the person who sent it. For further details on the 
MESSAGE command, see page 37, 


(1) See 


APL Language, p. 2. 


— —_ 


B. EXIT FROM CANSIM INTERACTIVE PROGRAM 


There are two ways to leave the CANSIM Interactive program: 
ime Type LSIOPW in. repLy..to, any. question. 


ow) Press, arcarriage RETURN after ‘|'COMMAND?" 
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CHAPTER II - TEN COMMANDS IN CANSIM INTERACTIVE PROGRAM 


CIS enables a user at a low speed remote terminal to access the CANSIM Main Base 
by means of a conversational interactive program. This chapter explains how to use 
the ten commands in the CANSIM Interactive program. Six of the ten commands are 
concerned with data retrieval, allowing the user to obtain data in a variety of for- 
mats, printed, on tape or disk, or in an active APL workspace(72) .“ethe other oun 
commands are complementary to the data retrieval commands, enhancing the general 
applicability and convenience of the system. 


As a conversational program, CANSIM Interactive "prompts" the user through the 
commands; that is, the program asks the user questions, the answers to which define 
tasks to be performed by CIS. The amount of prompting varies from command to command, 
but the differences are generally self-explanatory. In many cases, prompting not only 
includes a question, but it also provides the possible answers among which the user 
must choose. Four of the data retrieval commands, which involve the longest and most 
complex prompting, offer experienced users the option of suppressing the prompt and 
providing the required information in a specific format without help. 


There are two "phases", or parts, of three of the data retrieval commands and 
one of the complementary commands. In PHASE 1, the user defines a request by res-— 
ponding to a few questions. CIS then automatically generates a batch job(3) and 
creates a file to hold the results. In PHASE 2, the user accesses the file created 
at the end of PHASE 1. The other six commands do not involve batch jobs and, there- 


fore, have no "phases". 


NOTE: 


1. The file created by CIS in PHASE 1 is held for seven days before being auto— 
matically deleted when a user signs on to the system. If a user does not 
sign on then these files will not be deleted. 


(2) "See "APL Eanvuage. pe 15. 
(3) Familiarity with this terminology is not essential to effective use of the system. 


p= (8 _ 


A. SIX DATA RETRIEVAL COMMANDS 


As mentioned above, CIS includes six data retrieval commands. The first three, 
TABLE, DISPLAY and MANIPULATE, include two "phases", and a PROMPT option, and involve 
exactly the same user/system interaction. The only difference among the three is the 
form of the resulting output. 


The TABLE command results in a printed table, with the observations in the 
retrieved time series printed in columns, the number of columns depending on the 
number of series retrieved, the size of the machine's platen and the width of each 
column of data. This command is especially recommended when several series from the 
same matrix are being retrieved, as the matrix header and notes will be printed once 
for the entire table. It is to be avoided when series of different periodicity are 
desired. 


The DISPLAY command also results in output printed on the user's low-speed 
terminal, but in a different format. The matrix header and notes are printed and the 
data follow, with observations running both across and down the page, depending on 
the periodicity of the data, the width of the machine's platen and the width of each 
column of data. If the data is subannual, the quarterly, monthly, etc., observations 
will be printed across the page. This command is appropriate when the retrieval in- 
cludes series from several different matrices, as the matrix header and notes are 
Nattached'"' to the individual series. 


The MANIPULATE command results in the availability of CANSIM data in the user's 
active APL workspace in vector form. (See the APL Language for an explanation.) 
A reference table is available, listing the series name, the period covered, the num- 
ber of data points, and the frequency of the series retrieved. However, no matrix 
headers or notes are printed. It is, therefore, recommended that the user retrieving 
data with the MANIPULATE command make descriptive notes from the CANSIM Main Base 
Series Directory when the relevant series identifiers are being located. 
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I. TABLE, DISPLAY, AND MANIPULATE COMMANDS 


a. PHASE 1 — PROMPT 


In PHASE 1, the user specifies the parameters of the retrieval, that is, he 
indicates the series identifiers, time period and security words of the time series 
to be retrieved. As mentioned above, PHASE 1 of these three commands can be 
executed with or without prompting. 


EXAMPLE 3 
1. COMMAND? TAB(DIS) (MAN) 
Dose PUASEW Ie ORDZPUTY 22 ‘la 
3. PROMPT? Y/N? me 


At line 1, the user indicates the command he wishes to use, and if he chooses 
one of the above three commands, he is specifying the format he wishes his retrieved 
data to take. There are ten "right" answers to the question 'COMMAND?". If the 
user fails to respond with one of those ten, the program will shortly respond with 
a "NOT IMPLEMENTED.."' error message, and will re-start (4). 


EXAMPLE 4 
1. COMMAND? TAN 
2. PHASE 1 OR 2? 1/2? et 
3. NOT IMPLEMENTED 
4, COMMAND? 


NOTE: 


The first three letters of any of the commands adequately replies to the ques- 
tion "COMMAND?" .... The whole word will also be accepted. Example, either 
MANIPULATE or MAN is acceptable. 


If one of the data retrieval commands is correctly entered, the program will 
implement the command. 


EXAMPLE 5 
1. COMMAND? DIS 
2, PHASE CIM OR Dovel) 2? al 
3. PROMPT? Y/N? i 
4, CANSIM OR DATABANK? C/D?. C 


At line 3, the user is offered the PROMPT option. As mentioned above, it) the 
user responds to the question "PROMPT?" with Y (or YES), the CIS will ask the user 


(4) Other error messages are listed and explained in Appendix A. 


a series of questions as in the example below. Regardless of the user's answer at 
line 3, the program will ask the question "CANSIM OR DATABANK? C/(p?) athstsiss 
will CANSIM or Databank series identifiers be used? (5)Each series has two identi- 
fiers; regardless of the type of identifiers used, the data retrieved will be the 
same. However, identifiers on retrieved data may not coincide with identifiers used 
aner BASE « 


(i) 


1. Both CANSIM and Databank identifiers are provided on a DISPLAY printout. 

2. Regardless of type of identifiers used in PHASE 1, CANSIM identifiers are 
used to identify series in a TABLE printout. 

3. Regardless of type of identifiers used in PHASE 1, Databank identifers are 
used to identify series in an active APL workspace in the MANIPULATE com- 
mand. (If the RENAME option is used the series will be identified by the 
mame given, regardless of command.) 


Retrieval by CANSIM Identifiers 


The next four questions will depend on the answer at line 4. If CANSIM iden- 


tifiers are used, a prompted retrieval proceeds as follows: 


EXAMPLE 6 
1. COMMAND? 
Pe CHASE, 1) ORG2?7) 1/22 
3. PROMPT? Y/N? 
4. CANSIM OR DATABANK? C/D? 
5. MATRIX NO.? 
6. ALL/SPECIFIC/RANGE? A/S/R? 
[eet LIMLT? 


Lines 1 - 4 have been explained. At line 5, the user is asked for the matrix 


number of the data to be retrieved. (The matrix number is the first element in the 
CANSIM identifier.) At line 6, the user is asked how many series from that matrix 
are desired, 


ike 


If the user responds with an "A" to the question "A/S/R?", the program will ask 
for a LIMIT on the number of series to be retrieved (line 7). For example, "A" 
in reply to line 6 combined with a 5 in response to line 7 will result in the 
fteerieval.of the-first 5)series in btheymatrix:: :Wienovreply isveiven to dine’, 
all series in the matrix will be retrieved. 

If the user responds with an "R" to the question "A/S/R?", the program will ask 
"FROM SERIES NO?" and "TO SERIES NO?", that is, ''the RANGE of series to be re- 
trieved should run from series to series 2". The user's response 


will fill in the blanks, resulting in the retrieval of the series named and all 


series in between. 

If the user responds with an "S" to the question "'A/S/R?", the program will ask 
for a SPECIFIC series identifier. After the series identifier is entered, the 
question "RENAME?" will be asked. If this option is exercised, the retrieved 
series will be identified with the answer to the question ''RENAME?", rather than 
as indicated above. The new name is limited to eight characters in length, 


(5) See the CANSIM Summary Reference Index for an explanation of this question. 


the first of which must be alphabetic. If the RENAME option is not desired, 
execute a carriage RETURN in response to this question. 


NOTE: 


The RENAME option is not offered with the ALL or RANGE responses because the 
system is not set up to identify which series would be attached to which new 
name. 


After the series identifiers have been specified, the security word for the 
series is requested. If the desired series is PUBLIC and no security word is re- 
quired (check the CANSIM Main Base Series Directory), the appropriate answer to the 
question "SECURITY WORD?" is a carriage RETURN. If the series is SECURE on CANSIM, 
and the user has obtained the security word from the originators of the data, it 
should be entered over the "mask" printed opposite the question ''SECURITY WORD?". 


NOE: 


Some terminals string the security word "mask" out in a row. In this case, 
enter the security word at the end of the "mask". 


EXAMPLE 7 

1. COMMAND? DIS 

2 SRACHASE TAO a2” wat] 27 iL 

3. PROMPT? Y/N? x 

4, CANSIM OR DATABANK? C/D? CC 

5. MATRIX NO.? ll 

6. ALL/SPECIFIC/RANGE? A/S/R? S 

7. SERIES NO.? iT 

8. SECURITY WORD? KN 
9. START DATE? 7501 
10. END DATE? * 

11. RENAME? 

12. MORE? Y/N? N 
13. REQUEST DATA NUMBER IS 04 

14. DO YOU WANT HIGH PRIORITY? Y/N? N 
15. ASSIGNED JOB NAME IS: RO155097 
16. JOB RO155097 EXECUTING PRIORITY 7 
17. CONTINUE MONITOR? Y/N? N 


Next the user is asked to specify the time period to be covered by the re- 
trieved series. At line 9 in Example 7 the desired "START DATE?" is requested; at 


line 10, the desired "END DATE?" is requested. The format for providing this infor- 
mation is YYMMDD. 


where, YY indicates the desired year, for example, 1971=71 
MM indicates the desired month, for example, April=04 
DD indicates the desired day, for example, January 4, 1976=760104 
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NOTE: 


CANSIM includes no daily or weekly data; therefore, the DD part of this format 
is irrelevant for the TABLE, DISPLAY and MANIPULATE commands. However, this 
basic format is used in the NEWSFLASH command, where the specification of a de- 
sired day is relevant. (See page 34 .) 


An alternative to the YYMMDD type of answer is available in the asterisk, ac- 
Peola esi neresponse. to either. VS TART DATE? Usor,. JEND.DATE?”.. [lf thesasterisk is 
wsediin reply to "START DATE?", the series.retrieved will start with the, earliest 
observation available on CANSIM for that series. If the asterisk is entered in 
response to the question "END DATE?", the series will end with the latest (most 
recent) observation available on CANSIM for that series. Hence, if asterisks are 
used in response to both questions, all data available on CANSIM for that series 
will be retrieved. 


NOTE: 


Not all series on CANSIM have the same periodicity, nor are they up-dated with 
the same timeliness or frequency. If asterisks are used to indicate the time 
period to be covered for several series in one retrieval, it should not be ex- 
pected that all series will necessarily cover the same time period in the result- 
ang output. 


At line 11, in reply to ''RENAME?", the carriage RETURN will result in the series 
not being renamed. 


Finally, at line 12, CIS asks the question 'MORE? Y/N?". If the user answers 
"y", the procedure will restart with the question ''MATRIX NO.?". If the user an- 
swers "N'', request data number will be issued (line 13). At line 14, the question 
"DO YOU WANT HIGH PRIORITY? Y/N?" is asked. At peak system usage times, if very 
rapid "turnaround" is required, that is, if the data are required very quickly, "high 
priority'' is sometimes useful. However, for most applications, the normal job sche- 
duling results in adequately rapid execution of retrieval jobs. (CPU time for high 
priority retrievals costs more for the batch processing than for those without top 
Priority. ) 


NOTE: 


The maximum number of jobs in the system under one APL number at any one time 
is. 25. 


Once the JOB NAME has been generated, the job has started processing. A message 
reporting the STATUS of the job in the system will be printed automatically, and the 
user will be offered the option of monitoring the job as it processes. If the user 
monitors the request (replies "Y" to the question ''CONTINUE MONITOR? Y/N?'') status 
reports will be provided until the job has completed execution. After the STATUS 
report "JOB RNNNNNNN HAS FINISHED EXECUTION", the CANSIM Interactive program auto- 
matically enters PHASE 2 (see page 19). 


(ii) Retrieval by Databank Identifiers 


The questions asked on lines 1 - 4 and 8 - 10 are the same regardless of whether 
CANSIM or Databank identifiers are used. However, if the question "CANSIM OR DATA- 
BANK? C/D?" is answered with a "D'" at line 4, the series identifier prompting will 
be slightly different from that described above. 


At line 4, the reply when using Databank Identifiers to the question "CANSIM 
OR DATABANK? C/D?'is ="D"?* "ine next question is “RANGE?” Y/N?) that” to omaremy 
retrieving a RANGE of series (or a single series)? If you answer "Y", the program 
will ask "FROM DATABANK NO.?" and ''TO DATABANK NO.?'" (see Example 9). These ques- 
tions are analogous to the "FROM SERIES NO.?" and "TO SERIES NO.?" questions in the 
RANGE retrieval using CANSIM identifiers. However, the RANGE of series retrieved 
will be defined by the answers to these two questions, even if that RANGE extends 
beyond one matrix. If the answer to the question "RANGE? Y/N?" is "'N" (see 
Example 8), the inference is that a single series is desired and the program will 
ask 'DATABANK NO.?', and "RENAME?" offering the user the RENAME option. 


NOTE: 


Databank identifiers are listed in the CANSIM Main Base Series Directory with 

blanks between their alphabetic and numeric characters. In CIS, these blanks 

are omitted; for example, D#AbbBK1 in the Series Directory is entered as Dl in 
CES. 


After the Databank identifiers have been specified, lines 8 - 11 follow in 
both examples. If the question "MORE? Y/N?" is answered "Y", the procedure re- 
starts with the question ''RANGE? Y/N?". 


EXAMPLE 8 


COMMAND? 

PHASE@ IN ORR22* 17°22 
PROMPT? Y/N? 

CANSIM OR DATABANK? C/D? 
RANGE? Y/N? 

DATABANK NO.? 

RENAME? 

SECURITY WORD? LOO ESOGE 
START DATE? LOL 
END DATE? * 
MORE? Y/N? N 


oO 
= 
WN 


i= 
ee Umea! 


FQ SOs Go ISON OE Cops 


il ee 


EXAMPLE 9 


COMMAND? IS 
PHASE" 1 OR®27™ 1/3 1 
PROMPT? Y/N? Y 
CANSIM OR DATABANK? C/D? cS 
RANGE? Y/N? Y 


UPwWNHE 
ie) 


6. FROM DATABANK NO.? D1 
7. TO DATABANK NO.? D5 
8. SECURITY WORD? XXXXXXX 
9. START DATE? 7101 
10. END DATE? x 
11. MORE? Y/N? N 


DreeEHASE ol y—sNO. PROMPT 


For users familiar with CIS, the NO PROMPT option offers a faster means of 
entering the information required to generate the retrieval job. Lines 1 - 4 are 
the same under the NO PROMPT and the PROMPT options; only the answer to line 3 is 
different. 


EXAMPLE 10 
1. COMMAND? DIS 
2. PHASE 1 OR 2? 1/2? al 
3. PROMPT? Y/N? N 
4. CANSIM OR DATABANK? C/D? D 
sinactys 


A question mark appears at line 5 to indicate that CIS is ready to receive the 
remaining retrieval parameters. These are entered in a string following the ques- 
tion mark. All parameters must be separated by commas, but the required format de- 
pends on whether CANSIM or Databank identifiers are used. 


(1) Retrieval by CANSIM Identifiers 


The format for CANSIM Identifiers is as follows: 


TP SECURITY ‘OPTION Center "S”™ for SECURE or “P'’ for PUBLIC — see CANSIM Main 

Base Series Directory) 

START DATE 

END DATE 

MATRIX NUMBER 

SERIES OPTION 

A - ALL series within matrix 

S - SPECIFIC series within matrix 

R -— RANGE of series within matrix 

6. If ALL is the fifth retrieval parameter chosen, a limit for the number of 
series to be retrieved may be specified. If RANGE is the fifth retrieval 
parameter chosen, the ''FROM" and "TO" series number must be specified. 
If SPECIFIC is the fifth retrieval parameter chosen, the series may be 
renamed. If this option is not used, the series will be identified by 
its Databank number. 


U1 & W Nd 


The following example illustrates the use of the NO PROMPT with CANSIM 


Identifiers: 


EXAMPLE 11 


CANSIM OR DATABANK? C/D? Cc 

SSP eel ULsle ks 

5101.7101 INVALID ** REQUEST IGNORED** 

The START DATE and END DATE are separated by a period, it should be a comma. 
See Appendix A for an explanation of the error message. 


Ue LU lee LO etre) 
The first five series in matrix 1 are requested. 


Ce es ea ra a ls Sd ee 
A RANGE of series from series 1.1 to series 1.4 in matrix 1 is requested. 


fee Keri adrs Cai Rip gs Mel ere ee BANS WM ya 
DEO OG, 0,8 

Series 1.2 in matrix 1 is renamed IMMASIA. Series 1.1 and 1.4 will be iden- 
tified by their Databank numbers. Because "S" is specified for SECURITY 
OPTION, the mask appears on the following line to allow the user to enter 
the SECURITY WORD. 


NRE 2 gs rs 8 hE Saale cs 


1.1 INVALID**REQUEST IGNORED** 


Option 5 was omitted, that is, A, R or S was not specified. 
When retrieving SPECIFIC series within a matrix, several single series can be 


specified on the same line as long as their other parameters are the same, (that is, 
SECURITY, START DATE and END DATE, and MATRIX NUMBER). 


(ii) 


WN FR 


Retrieval by Databank Identifiers 


ine tormat for Databank Identitication 1s as) fol bows: 


SECURITY OPTION Center "S for SECURERor asfOomerUBiaLe) 

START DATE 

END DATE 

SERIES OPTION 

- RANGE of series 

- SPECIFIC series 

If RANGE is chosen as the option, the "FROM" and "TO" DATABANK numbers must 
be specified. 

If SPECIFIC is chosen as the option, the series may be renamed. Several 
single series may be specified on the same line if their SECURITY, START DATE 
and END DATE parameters are the same. 
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The following example illustrates the use of the NO PROMPT with Databank iden- 
citiers: 


EXAMPLE 12 
CANSIM OR DATABANK? C/D? D 


eee ath, UL 5,DL) 
Series D23 to D25 are requested. 


b. ? P,*,*,S,D27,TOTIMM, D28,D32, ASTAIMM 
Series D27 is renamed TOTIMM, Series D28 is not renamed and Series D32 is 
renamed ASIAIMM. 


Cam 607-001, 7404550602456 
Series D602456 is requested from January 1970 to April 1974. 


(iii) Carrying Parameters Forward 


After each line of parameters is transmitted, the program will print a 
question mark to start the next line. If so desired, retrieval parameters 
can be carried forward from line to line rather than re-entered on each line. 
Using either CANSIM or Databank identifiers this is done by entering a comma 
for each parameter that is to be carried forward. 


NOTE: 


If one parameter is changed, those parameters following the changed para- 
meter must be re-entered and cannot be replaced by commas, even if they 
are the same as on the previous line. 


EXAMPLE 13 


2 P,*,*,R,D1,D6 
Let, 8oD 27-5 DO? 
Series Dl to D6 and D27 to D32 are requested. 


(iv) Submitting Jobs of a Recurring Nature 


If you have a group of series which are to be retrieved regularly, it 
is possible to create an APL variable (6), store it in your APL library, and 
submit your job using the NO PROMPT. 

EXAMPLE 14 
A. REQUESTe'P,*,*,S,D5129,D2855,D1439, D607001,D51190,D603060' 
)WSID ANYNAME 
WAS CONTINUE 
) SAVE 
SAVED 15.45.21 08/08/76 ANYNAME 
. )LOAD 601 CANSIM 
ENGLISH/FRANCAIS? E/F? E 


sO’ Ua oe~ Co NS 


(6) See APL Language, p. 14. 


8. COMMAND? DIS 
9, PHASE ORe22 1/2? at 
10. PROMPT? Y/N? N 
11. CANSIM OR DATABANK? C/D? D 


12. 2? =REQUEST;ANYNAME 
1345 SAVED M5512 108 08/76 


Bee )LOAD 601 CANSIM 
Pig ay Aino ala ikep ce Pe ly; 
3. ENGLISH/FRANCAIS? E/F? E 
4. COMMAND? DIS 
5 .auPHASE GleORe2 2nedk/ 28 1 
6. PROMPT? Y/N? N 
7. CANSIM OR DATABANK? C/D? D 
8. 2? P,*,*,S,D5129,D2855,D1439, D607001, D51190, D603060 


eh ee a ee ee ee ee 


In example 14, A and B are identical retrievals. In A, once we are signed on 
to APL we create an APL variable called REQUEST (line 1); the variable is enclosed 
between a pair of single quotation marks. This variable is saved in the User's 
Library (line 4) where it remains until the user removes it: 


EXAMPLE 15 
has ete )WSID MORE 
De WAS CONTINUE 
as TOR CulbsSle lees tl ein, eG LO dance 
4. )SAVE 
5. SAVED 16.42.18 08/08/76 MORE 
6. LOAD 601 CANSIM 
7 eecAVEUe sls Lor 1AnO 2 jad gg 
8. ENGLISH/FRANCAIS? E/F? E 
9. COMMAND? DIS 
10. *PHASE A ORe22 1/22 i 
11. PROMPT? Y/N? N 
12. CANSIM OR DATABANK? C/D? (e 
13. ? P,7001,*,=JOB;MORE a 
B. 1. COMMAND? nS 
2, S PHASE I) ORS 2? 91/2? any 
3. PROMPT? Y/N? N 
4. CANSIM OR DATABANK? C/D? a 
Saori PET O0Inke eS 1 le al sds dt On leo heel Omni 


In example 15, A and B again are identical retrievals using the CANSIM Iden- 
tification Numbers. Note that the APL variable created can contain any group of 
parameters which are acceptable using the NO PROMPT, but it does not necessarily 
contain the entire request. When submitting the CANSIM retrieval, the variable 
name must be preceded by an equal sign (=) and followed by a semicolon (;), then 
the workspace name containing the variable. 


NOTE: 


In order to terminate the entering of retrieval parameters with NO PROMPT, press 
RETURN when the question mark is printed for the next line of parameters. The re- 
trieval request will then begin executing. 


Sy PHASE 2 


As noted above, PHASE 2 of the CANSIM Interactive program provides the user 
with access to a file created as the result of a retrieval generated in PHASE l. 
There are two ways to enter PHASE 2 of the program. 


(i) Automatic Transfer to PHASE 2 


When the retrieval job generated in PHASE 1 is completed, the job status mes- 
sages described on page 13 will inform the user that the job has finished execution. 
The program will then automatically go into PHASE 2. 


(ii) Sign-On to PHASE 2 


As noted on page10 the second question in the TABLE, DISPLAY and MANIPULATE 
commands in the CANSIM Interactive program is "PHASE 1 OR 2? 1/2?". To access a 
specific file in PHASE 2, the command in PHASE 2 must be the same as that used in 
PHASE 1 when the retrieval job was generated. When the question ''PHASE 1 OR 2? 1/22" 
is answered "2", the program asks for a REQUEST DATA NUMBER. The user enters the 
REQUEST DATA NUMBER provided at the end of PHASE 1 for the specific file desired. 

If that file is not available, the following message will be printed: 


04 JOB NOT YET FINISHED 


The output of PHASE 2 depends on whether the data were retrieved using the 
MANIPULATE command or the TABLE or DISPLAY commands. 


If the job was successful using the MANIPULATE command, the series retrieved 
are brought into the APL workspace as vectors. The system then offers the user the 
choice of seeing the APL Data Reference Table created from the retrieval by asking 
"DO YOU WANT APL DATA REFERENCE TABLE? Y/N?" A reply of "Y" will result in a 
reference table being printed that shows which series were retrieved, their reference 
dates, the number of data points and their frequency. The series name shown in the 
table is the Databank Identification, unless the series was renamed (see pagell). 
After the reference table is printed, the program will ask the question ''WANT 
RETRIEVAL ERROR MESSAGES? Y/N?" and provide the user with the option of seeing what 
error messages (if any) were generated by the job. These messages differ from those 
listed in Appendix A. For a list and explanation, see Appendix B. The user then 
exits from the CANSIM Interactive Program into APL language (see APL Language, p. 7) 
and can manipulate the retrieved series using APL. If the user chooses not to print 
the APL Data Reference Table then the system would immediately offer the option of 
displaying any retrieval error messages. 


The following example illustrates signing on to PHASE 2 in the MANIPULATE com- 
mand to obtain previously requested data: 


EXAMPLE 16 

i COMMAND ? MAN 

»2 PHASE 1 OR 2? 1/2? eA 

Bh REQUEST DATA NUMBER? 08 

A DO YOU WANT APL DATA REFERENCE TABLE? Y/N? Y 
=, CANSIM APL DATA REFERENCE TABLE 


OE = 


Ge SERIES START DATE END DATE NO. OF DATA POINTS FREQUENCY 
ric D2 760100 760400 Z QUARTERLY 
Si D3 760100 760400 2 “QUARTERLY 


WANT RETRIEVAL ERROR MESSAGES? Y/N? ~ 
CANSIM RETRIEVAL ERROR MESSAGES 

NO ERRORS DETECTED 

COMMAND? 


END OF EXECUTION 
* 


* 


At this point the user is in APL and has two variables identified as D2 and D3. 
Note that in reply to "WANT RETRIEVAL ERROR MESSAGES? Y/N?" we replied "Y''. The 
message 'NO ERRORS DETECTED" indicates that there were no error messages generated 
by the job. 


When data are retrieved in TABLE or DISPLAY Format, the "CANSIM APL DATA 
REFERENCE TABLE' does not appear. Immediately, following the REQUEST DATA NUMBER, 
the question "PAGE ALIGNMENT? Y/N?" is printed; a reply of "Y" will give the user 
the opportunity to align each page of output. Two asterisks are printed at the left 
side of the page and the system will go into a wait state (see example 17) to allow 
the user to move the carriage to the top of a new page. When the paper is ready, 
the printing of output can be started by pressing RETURN. 


EXAMPLE 1/7 
1. PAGE ALIGNMENT? Y/N? Y 
ay * z 
enetx 


(System In Wait State) 


When there is more than one page of printed output, the double asterisks will 
be printed at the bottom of each page allowing alignment of the next page. Two co- 
lons will be printed at the bottom of the last page. The user is then offered the 
option of printing the Retrieval Error Messages. 


If the reply to "PAGE ALIGNMENT? Y/N?" is "N", printing will start immedia- 
tely following the carriage RETURN; it will continue printing until the output is 
finished. When the output has completed printing, the question "WANT RETRIEVAL 
ERROR MESSAGES? Y/N?" will be asked (see Example 18). As above, the user may 
print the messages and continue with one of the valid CIS commands or may terminate 
execution of the program. Unlike in MANIPULATE, when PHASE 2 is completed the re- 
trieved data do not remain in the APL workspace. 


EXAMPLE 18 


WANT RETRIEVAL ERROR MESSAGES? Y/N? ¥ 
CANSIM RETRIEVAL ERROR MESSAGES 


00003S 002314 R — MATRIX FROZEN, DATA NOT AVAILABLE TO 
USERS 
00001G 001000 1 R - START DATE INCOMPATIBLE, SUBSTITUTING 


DATE 750300 
JOB SUCCESSFUL - ACCEPTING ERRORS - CHECK 
R -— AND W - TYPE ERRORS 


COMMAND? 


END OF EXECUTION 
* 


* 


There were error messages generated by this job. See Appendix B for further expla- 
nation of these messages. 


Ls ai 


2. BATCH COMMAND 


a. TABLE AND DISPLAY 


The BATCH command is particularly useful for printing large requests which would 
take a long time to print on a typewriter terminal. The user submits the request via 
a typewriter terminal, but the printing is done at a high-speed printer. TABLE, 
DISPLAY and MANIPULATE formats are available and retrieval parameters are entered in 
response to the same questions as are asked in the TABLE, DISPLAY and MANIPULATE 
commands. However, there are no "phases'' to the BATCH command and BATCH jobs are 
not monitored by the STATUS command. 


EXAMPLE 19 

1. COMMAND? BAT 

2. PROMP LE? BYiN? iy 

3. REMOTE STATION? (RETURN FOR CENTRAL SITE) 
4. TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? Hh 
5. CANSIM OR DATABANK? C/D? ce 
6. MATRIX NO.? 8388 

7. ALL/SPECIFIC/RANGE? A/S/R? A 

S RLM 

9.) s SECURITY: WORD? XXXXXXX 
10. START DATE? * 
11. END DATE? x 
12. MORE? Y/N? N 

13... DO YOU WANT HIGH PRIORITY? Y/N? N 
14. ASSIGNED JOB NAME IS: ROS 5097 

15. JOB 0155097 EXECUTING | PREORITY 7 
16. CONTINUE MONITOR ? Y/N? N 


The reply to the question ''REMOTE STATION? (RETURN FOR CENTRAL SITE)' is a num- 
ber indicating a high-speed printer for which the user's APL number has been autho- 
rized(7), Requests for which no high-speed printer is designated (a RETURN is enter- 
ed) are automatically routed to the central site of the host bureau. 


In Example 19, a TABLE printout has been requested (see line 4). Lines 5 
through 13 are identical to the prompting as already described. The request is 


identified by the JOB NAME, that is RO155097 in the above example. 


To have the printout mailed call the host bureau and provide the JOB NAME. 


(7) Authorization and a complete list of acceptable printers can be obtained from 
the host bureau or the CANSIM Staff. 
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EXAMPLE 20 
1. COMMAND? BAT 
2. PROMPT? Y/N? > hy 
3. REMOTE STATION? (RETURN FOR CENTRAL SITE) 
4. TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? if 
5. CANSIM OR DATABANK? Cp? c 
6a) BoP Pe SOL, #155. 1 ay 
7. *4 
8. DO YOU WANT HIGH PRIORITY? Y/N? N 
9. ASSIGNED JOB NAME IS: RO215097 | 
10. JOB RO215097 EXECUTING PRIORITY 7 
11. CONTINUE MONITOR? Y/N? N 


12. COMMAND? 


13. END OF EXECUTION 
* 


* 


Example 20 shows the NO PROMPT option. 


b. MANIPULATE 


When using MANIPULATE format (Example 21A) in BATCH the user creates a file of 
the data requested. The output DATA SET NAME must begin with A1650.APL. Rather than 
going into PHASE 2 of CIS, the user can access the file created through a self- 
starting workspace called APLFILE, (Example 21B) and manipulate the retrieved series 
using APL. Only when the user chooses to read the data set does the system offer the 
option of printing the APL Data Reference Table (line 5). This workspace also allows 
the user to scratch a data set(s) which has been created. (Example 21C) 


NOTE: It is the user's responsibility to scratch these data sets. 


EXAMPLE 21 
A. 1. COMMAND? BAT 

2. PROMPT? Y/N? N 

3. REMOTE STATION? (RETURN FOR CENTRAL SITE) 

4. TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? M 

5. OUTPUT DATA SET NAME? A1650.APL.TEST 
6. CANSIM OR DATABANK C/D? D 

peu? P7501 R, DIL DIO 

BTrE9 

9. DO YOU WANT HIGH PRIORITY? Y/N? N 
10. ASSIGNED JOB NAME IS: RO095097 

11. JOB RO095097 EXECUTING PRIORITY 7 


12. CONTINUE MONITOR? Y/N? N 


OS DATA SET NAME? 
END OF EXECUTION. 


Bae ie )LOAD 601 APLFILE 

2. SAVED 15.19.14 08/08/76 

3. OS DATA SET NAME? A1650. APL. TEST 

4. “READ(I)? “GR SCRATCH(2)?, 47/27 1 

5. DO YOU WANT APL DATA REFERENCE TABLE? Y/N? Y¥ 

6. SERIES START DATE END DATE NO. OF DATA POINTS FREQUENCY 
D1 750100 760400 6 QUARTERLY 
D2 750100 760400 6 QUARTERLY 
D3 750100 760400 6 QUARTERLY 
D4 750100 760400 6 QUARTERLY 
D5 750100 760400 6 QUARTERLY 
D6 750100 760400 6 QUARTERLY 
D7 750100 760400 6 QUARTERLY 
D8 750100 760400 6 QUARTERLY 
D9 750100 760400 6 QUARTERLY 
D10 750100 760400 6 QUARTERLY 

7. END OF EXECUTION. 

Crea )LOAD 601 APLFILE 

2. SAVED 15.19.14 08/08/76 

3. OS DATA SET NAME? A1650. APL. TEST 

he, READ C)-20 OR SCRATCH (2)2) 922?) 2 

5. DONE 

6. 

ie 


Can Se LAPE OR SDISK 


CIS can also be used to generate tape or disk output from CANSIM. Data can be 
retrieved inveither of two formats, "UTILITY or. (DATABANK... 1Details.of theduanecord 
structure can be obtained from the CANSIM Users' Manual for Data Retrieval and 
Manipulation, (Catalogue #12-531, Statistics Canada). 


When tape is specified as the output medium, and the tape is not transmitted, 
the user chooses between keeping the tape at the host bureau, having the tape sent 
to the user by Banker's Dispatch, or having the tape sent to the user by Voyageur 
Bus Lines. 


In all retrievals, the 0.S. batch catalogued procedures are used. This allows 
the use of the default options of the catalogued procedures with the exception of 
the DATA SET NAME. This must be specified and must begin with A1650.APL. 


Except for those questions in which all choices are displayed, a carriage 
RETURN will result in the choice of the catalogued procedure default option (a 
summary of default options is given on page 28). 


Since the questions vary depending on preceding responses, it is easiest to 
illustrate question flow with the attached chart and several examples. 


es eS 


eR 
( START ~) 


¥v 
REMOTE STATION? (RETURN FOR CENTRAL SITE) 


TAB / DIS / UTI / DBNK / MAN? TIYAD) /SMOY CBI Me 


DATA TO BE WRITTEN ON 
TAPE, OR: DISK? T/D? 


TAPE DISK 


MAX. NO OF 
SERIES TO BE 
RETRIEVED? 


VOLUME SERIAL NO? 


ve DATA SET TO BE * 
TRANSMITTED TO 
STC? Y/N? 


KEPT AT HOST BUREAU? 
SENT BY BUS? 

SENT BY BANKERS? 

d fay 32 


SPECIFICATIONS FOR 


CANSIM SERIES RETRIEVAL 


SUBMIT * = Default value exists 


(1) Prompt 


EXAMPLE 22 


WON ADM WN EF 


hh 
KO 


ee 
wh 


COMMAND? BAT 
PROMPT? Y/N? ie 


REMOTE STATION? (RETURN FOR CENTRAL SITE) 


TAB /DIS/UTI/DBNK/MAN? T/D/U/B/M? 
OUTPUT DATA SET NAME? 

DATA TO BE WRITTEN ON TAPE OR DISK? 
VOLUME SERIAL NO. ? 

DATA SET TO BE TRANSMITTED TO STC? 
TAPE TO BE KEPT AT HOST BUREAU(1) 

SENT TO YOU BY BUS(2) 

SENT TO YOU BY BANKER DISPATCH(3) 
CANSIM OR DATABANK? C/D? 
MATRIX NO.? 39 
ALL/SPECIFIC/RANGE? A/S/R? 

FROM SERIES NO. ? 

TO SERIES NO. ? 

SECURITY WORD? 

START DATE? 

END DATE? 

MORE? Y/N? 

DO YOU WANT HIGH PRIORITY? Y/N? 


U 
A1650.APL.UTIL. 


f/ Di ae 


Y/N? N 


1/2/32 o 


ASSIGNED JOB NAME IS: RO205097 


Example 22 creates a tape (line 6) in UTILITY Format (line 4) of CANSIM 


Ser lécpie-ietoml +o tnymatrix, 39 (lines lito, 14). 


at thes hbostibureaus icentralasite Cline. s). 


EXAMPLE 23 


OnNnDUN WD 


COMMAND? BAT 


PROMPT? Y/N? Me 


The BATCH listing will print 


REMOTE STATION? (RETURN FOR CENTRAL SLE eet, 


TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? 
OUTPUT DATA SET NAME? 


DATA TO BE WRITTEN ON TAPE OR DISK? T/D? T 
VOLUME SERIAL NO. ? 

DATA SET TO BE TRANSMITTED TO STC? Y/N? Y 
CANSIM OR DATABANK? C/D? D 
RANGE? Y/N? ng - 
FROM DATABANK NO. ? D1 

TO DATABANK NO. ? DLO 

SECURITY WORD? XXXXXXX 

START DATE? 7401 

END DATE? x 

MORE? Y/N? * 

DO YOU WANT HIGH PRIORITY? Y/N? N 
ASSIGNED JOB NAME IS: RO165097 

JOB RO165097 AWAITS EXECUTION 

CONTINUE MONITOR? Y/N? N 


Example 23 creates a tape (line 6) in UTILITY format (line 4) of CANSIM 
series Dl to D10 (lines 11-14). The BATCH listing will be printed at CANSIM, 
Statistics Canada (line 3) and the tape will also be transmitted there (line 8)(8). 


EXAMPLE 24 
1. COMMAND? BAT 
2. PROMPT? Y/N? aLy, 
3. REMOTE STATION? (RETURN FOR CENTRAL SITE) 
4. TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? U 
5. OUTPUT DATA SET NAME? A1650.APL. TEST 
6. DATA TO BE WRITTEN ON TAPE OR DISK? T/D? D 
7. MAX. NO. OF SERIES TO BE RETRIEVED? 
8. VOLUME SERIAL NO. ? 
9. DATA SET TO BE TRANSMITTED TO STC? Y/N? 


fe) ee 


10. CANSIM OR DATABANK? C/D? 
11. RANGE? Y/N? 

12. FROM DATABANK NO. ? 

13. TO DATABANK NO. ? 

14. SECURITY WORD? 

ASWASTART DATE? * 
16. END DATE? * 
17. MORE? Y/N? N 
18. DO YOU WANT HIGH PRIORITY? Y 


ger 
: 


/N? N 

Example 24 creates a disk file in UTILITY Format (line 4) of CANSIM series 
with Databank identifiers Dl to D7 at the host bureau (line 3). The parameters for 
the output devices (lines 5 to 8) follow the standards for the host bureau computer 
system. The OUTPUT DATA SET NAME (line 5) must start with Al650.APL. A particular 
volume may be specified if it is certain that space exists on that disk. If none is 
specified, as in the example (line 8), the system will store that file. When the 
number of series to be retrieved is specified (line 7) the required disk storage for 
the file is reserved. The default value is 100 series. 


A disk file created in this way cannot be accessed through CIS: however they 
can be accessed using utility functions in APL. To use the disk file in batch 
processing, the "VOLUME SERIAL NO." listing must be consulted. 


(ii) No Prompt 


The BATCH command also offers a NO PROMPT option for tape and disk output. 


(8) The user should call CANSIM Staff (613) 995-0575 before submitting the job and 
ask if the tape drive can be used for a transmit. After the job is submitted the 
user should also call and give the JOBNAME to the operator. 


EXAMPLE 25 


\O OO) SJ On Gi eS Na 


ie 
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COMMAND? BAT 

PROMPT? Y/N? N 

REMOTE STATION? (RETURN FOR CENTRAL SITE) 
TAB/DIS/UTI/DBNK/MAN? T/D/U/B/M? B 

OUTPUT DATA SET NAME? A1650.APL.MASS 


DATA TO BE WRITTEN ON TAPE OR DISK? T/D? 
VOLUME SERIAL NO. ? 
DATA SET ‘TO BE RANSMITTED TOySTC?2e y/N@ N 
TAPE TO BE KEPT AT HOST BUREAU(1) 

SENT TO YOU BY BUS(2) 

SENT TO YOU BY BANKER DISPATCH(3)? 1/2/3? 
SINGLE OR DOUBLE PRECISION? S/D? 
CANSIM OR DATABANK? G/D2 
TaPRS 8,4 3054 
z 
DO YOU WANT HIGH PRIORITY? Y/N? 2: 


|r 


lalmirm 


Lines 1-9 are the same as those generated with the PROMPT option (Example 19). 


In this example the user has created a high-speed tape (line 6) in DATABANK format 
(line 4) and must specify if the tape is to be in single or double precision (line 


LO) 


After this information has been entered, the system will respond with "CANSIM 


OR DATABANK? C/D?'", as with the NO PROMPT option in the TABLE, DISPLAY and MANIPULATE 
commands. 
DATE, END DATE, etc. 


MAX. NO. OF SERIES TO BE RETRIEVED? 


The CANSIM retrieval parameters are to be entered, that is SECURITY, START 


DEFAULT PARAMETERS 


QUESTION DEFAULT OPTION 

OUTPUT DATA SET NAME? Must be specified starting with 
A1650.APL. 

DATA TO BE WRITTEN ON TAPE OR DISK? T/D? 9 Track tape/on-line Disk 

VOLUME SERIAL NO. ? SCRATCH (scratch volume) 


100 (Not used if tape is specified) 


DATA SET TO BE TRANSMITTED TO STC? Y/N? No transmit 


=J Gof 
3. GNP COMMAND 


The GNP command in CIS is different from the other four data retrieval commands 
in two ways. First, it enables the user to reproduce one or more of the tables found 
in Statistics Canada's quarterly National Income and Expenditure Accounts publication 
(Catalogue #13-001). Second, the tables are stored so that they can be accessed inter- 
actively by APL; thus, there are no "phases" in the GNP command as there are in the 
TABLE, DISPLAY and MANIPULATE commands. 


NOTE: 


The smallest unit of output using this command is a full table; individual series 
must be obtained using one of the other commmands. 


These tables are normally available from CANSIM on the day of release of the 
quarterly National Accounts. The output is designed for a 130-character line; an 
80-character line may be used; however, the output will be difficult to interpret. 
Using an 80-character terminal, each 130-character line of output from the tables 
will be split into two parts on the terminal. One part will contain the first 80 
characters of output and the second part will be the remaining 50 characters. 


To obtain a printout of all the tables and their respective analyses, one can 
type a "Y" after the question, 'DO YOU WANT ALL THE TABLES BY A BATCH JOB? Y/N?". 
(See Example 26, line 2). The tables can be printed at the host bureau's central site 
by simply typing in a carriage return after the prompt, ''TO WHICH REMOTE FOR PRINT- 
OUT? ('RETURN' FOR CENTRAL SITE') (Line 3). Alternatively, another valid Remote 
number may be entered. 


In order to obtain your output when it has printed call the host bureau and 
provide the JOBNAME. 


EXAMPLE 26 
1. COMMAND? GNP 
2. DO YOU WANT ALL THE TABLES BY A BATCH JOB? Y/N? Ng 


3. TO WHICH REMOTE FOR PRINTOUT? ('RETURN' FOR CENTRAL SITE) 
JOBNAME RO224097 PROGRAMMER NAME 'GTSS : 


4. COMMAND? 
5. END OF EXECUTION 
* 
* 
EXAMPLE 27 
1. COMMAND? GNP 
2. DO YOU WANT ALL THE TABLES BY A BATCH JOB? Y/N? N 
3. DO YOU WANT THE TABLE TITLES Y/N? N 
4. DO YOU WANT PAGE ALIGNMENT? Y/N? N 
5. DATA AVAILABLE FOR 68-76 WHICH DO YOU WANT? (YY OR YY-YY) 75-76 
6. ENTER TABLES WANTED (OR 'RETURN') at 


A list of the Table Titles (line 3) is provided in Appendix G; and the result 
of this request (line 6) is printed in Appendix H. 


The user can request page alignment by typing in a "Y" after the prompt ''DO 
YOU WANT PAGE ALIGNMENT? Y/N?" (line 4). Two asterisks (*) will be typed by the 
system on the terminal before printing of any of the National Accounts Tables. This 
pause will allow the user to align the paper after which the "RETURN" is pressed to 
start the output again. With no page alignment, the tables will be printed one 
after the other. 


National Accounts tables can be selectively retrieved by entering the table 
number, (or numbers separated by blanks or commas) after the prompt "ENTER TABLE(S) 
WANTED OR 'RETURN' (line 6). By pressing 'RETURN', one will obtain none of the 
tables. 


Analyses are available for the tables containing seasonally adjusted values. 
At the end of any of these tables, a list of item numbers that have statistics 
associated with them, are printed. An item number is printed on the left hand side 
of each of the National Accounts tables and one uses this (these) number(s) to res- 
pond to the prompt, ''WHICH ANALYSES DO YOU WANT (OR 'RETURN')". 


EXAMPLE 28 


ANALYSIS AVAILABLE FOR THE FOLLOWING ITEMS: 1 2 3 4 5.67 8.9 10 
WHICH ANALYSES DO YOU WANT (OR 'RETURN') 1 


a3 ieee 
4. CEA COMMAND 
The CEA command in CIS provides the user with access to the Current Economic 
Analysis Tables. The tables contain five years of annual data and two years of 
monthly or quarterly data for key economic indicators. The data is presented in a 
form to facilitate analysis, such as the percentage change from the previous period 
or the ratio of one series to another. 
NOTE: Asterisks (*) are printed when the figures are not available in CANSIM. 
The following tables are available: 
Table 1: Income and Expenditure Aggregates 
Table 2: Income and Expenditure Aggregates 
Table 3: Real Output by Industry 
Table 4: Canadian Balance of International Payments 
Table 5: External Trade 
Table 6: Prices and Costs 
Table 7: Prices and Costs, National Accounts Implicit Price Indexes. 
Table 8: Demand Indicators 
Table 9: Labour Force and Employment 


fare 10: Financial Indicators 


The tables are stored so that they can be accessed interactively by APL and 
therefore there are no phases in the CEA command. 


Presently a table is updated at least twice a week. However in approximately 
two months it will be possible to update a table as soon as any of the data in that 
table is updated on the CANSIM Main Base. If the user types a "Y" after the question 
"DO YOU WANT THE TABLE TITLES? Y/N?' an index is printed containing the table number, 
the complete table title, and the date and time that the table was last updated. The 
output is designed for a 130 character line although an 80 character line may be used 
causing one line of the table to be split over two lines on the terminal. 


To obtain a printout of all the tables one can type a "'Y" after the question 
"DO YOU WANT ALL THE TABLES BY A BATCH JOB? Y/N?" The table can be printed at the 
host bureau's central site by typing a carriage RETURN or at a remote printer by 
entering a valid remote number (Example 30). 


The user can request page alignment by typing a "Y'' after the prompt ''DO YOU 
WANT PAGE ALIGNMENT? Y/N?' Two asterisks will be typed by the system on the terminal 
before printing the tables and there will be a pause during which the user can align 
the paper. Enter a carriage RETURN to start the table printing. 


The tables can be retrieved selectively by entering the table number (or 
numbers separated by blanks or commas) after the prompt ''ENTER TABLES WANTED OR 
"RETURN'''. If RETURN is entered, no tables are printed. A complete index containing 
table numbers and titles etc. (line 3) is contained in Appendix I; the result of this 
request (line 5) is printed in Appendix J. 


EXAMPLE 29 

1. COMMAND? CEA 
2. DO YOU WANT ALL THE TABLES BY A BATCH JOB? Y/N? N 
3. DO YOU WANT THE TABLE TITLES? Y/N? N 
4. DO YOU WANT PAGE ALIGNMENT? Y/N? N 
5. ENTER TABLES WANTED OR 'RETURN' 6 
EXAMPLE 30 

1. COMMAND? CEA 
2. DO YOU WANT ALL THE TABLES BY BATCH JOB? Y/N? Y 


3. TO WHICH REMOTE FOR PRINTOUT, (RETURN FOR 
CENTRAL SITE) 


4, ASSIGNED JOB NAME IS: R2789805 


B. FOUR COMPLEMENTARY COMMANDS 


The commands described in this section of the Manual have been developed to 


facilitate best use of not only the CANSIM Interactive System itself, but also all 
information in the system. 
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1. NEWSFLASH COMMAND 


The CANSIM database is up-dated daily. The NEWSFLASH command provides access 
to a list of the matrices that have been up-dated on a given day. The name and number 
of the matrix and the period covered by the up-date are reported. 


The NEWSFLASH command includes two "phases", as do the TABLE, DISPLAY and MANI- 
PULATE commands. When the response to the question "PHASE 1 OR 2? 1/2?" is "1" in 
the NEWFLASH command, the program asks for the first and last day for which the list 
of up-dates should be retrieved. The format for entering the START/END DATES is 
YYMMDD (see page 12); asterisks are not accepted for the NEWSFLASH command. However, 
the NEWSFLASH for the current day can be retrieved by entering a carriage RETURN after 
the question "START DATE?" 


NOTE: 


The NEWSFLASH reports on a maximum of two months and a minimum of one month. At 
the first of each month, NEWSFLASH for the second preceding month are deleted. 

For example, on January 31, 1976, NEWSFLASHes were available for the entire months 
of December and January; as of February 1, 1976, NEWSFLASHes were available only 
for the month of January and February lst. 


To retrieve the CANSIM NEWSFLASH via APL, the COMMAND is NEWS. Besides the 
COMMAND, the user is required to enter the PHASE (i.e. 1 or 2) as well as the START- 
END date. 


EXAMPLE 31 
1. COMMAND? NEWS 
Oe PHAGE! OR 2291/2? I 
J GTART DATE? ~ - 750610 
4. END DATE? 750611 
5. REQUEST DATA NUMBER IS 25 
6. DO YOU WANT HIGH PRIORITY? Y/N? N 
7. ASSIGNED JOB NAME IS RO135098 
8. JOB RO135098 AWAITS EXECUTION 
9. CONTINUE REQUEST MONITOR? Y/N? N 
10. COMMAND? f 
END OF EXECUTION 
* 
* 
11. COMMAND? NEWS 
12. PHASE 1 OR 2? 1/27 y 
13. REQUEST DATA NUMBER? a 


14. PAGE ALIGNMENT? Y/N? N 


2. STATUS COMMAND 


The STATUS command enables the user to monitor for those CIS jobs which have 
been submitted to the system on his account using the TABLE, DISPLAY, MANIPULATE and 
NEWSFLASH commands. Two status levels are reported: EXECUTING and FINISHED. When 
a job has FINISHED, PHASE 2 may be used to access the file. 


NOTE: 


If the user has no jobs in CIS, the STATUS command will result in the message 
"NO JOB IN THE SYSTEM". (See example 33). 


EXAMPLE 32 

i COMMAND? STA 

2. REQUEST NUMBER DATE TIME TYPE STATUS 
31 760805 11:48 TAB FINISHED 
32 760806 13:25 TAB FINISHED 
34 760809 8:33 DIS FINISHED 
35 760809 13:25 DIS FINISHED 
36 760809 15:46 DIS FINISHED 


The sequence of the jobs is by time and date of submission. 


EXAMPLE 33 
D. COMMAND? STA 
ae NO JOB IN THE SYSTEM. 


oe COMMAND ? 


4, END OF EXECUTION 
* 


* 
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3. SCRATCH COMMAND 


The SCRATCH command enables the user to delete any file that has been created 
as the result of a job submitted in PHASE 1 of the TABLE, DISPLAY, MANIPULATE and 
NEWSFLASH commands. As noted on page 8, files older than seven days are automati- 
cally scratched when a user signs on to the system. However, if a file is no longer 
needed, its deletion using the SCRATCH command will minimize storage costs. 


When SCRATCH is the response to the question ''COMMAND?"', the program asks for 
the REQUEST DATA NUMBER of the file to be deleted. After that number is entered, the 
system will respond with 'DONE" and prompt for other REQUEST DATA NUMBERS until a 
blank RETURN. 


EXAMPLE 34 
iby COMMAND? SCR 
2. REQUEST DATA NUMBER? 31 
3. DONE 
4, REQUEST DATA NUMBER? 82 
Be DONE 
6. REQUEST DATA NUMBER? 34 
7. ‘DONE 
8. REQUEST DATA NUMBER? ae 
9. DONE 
Oy REQUEST DATA NUMBER? 36 
11. DONE 
12; REQUEST DATA NUMBER? 


US COMMAND ? 


4. MESSAGE COMMAND 


The MESSAGE command enables the user to send messages to the CANSIM Staff or 
the other CANSIM users. Messages sent using this command are filed by APL number and 
held for the intended recipient until he accesses and deletes them. APL numbers of 
CANSIM users can be obtained from the CANSIM Staff or from the host bureau. Because 
of the lock code, distribution of APL numbers does not compromise the security of the 
account. 


When MESSAGE is entered in response to the question "COMMAND?", the program 
asks for the APL number of the account to receive the message. A message is nine 
seventy~character lines in length; if this is inadequate, two or more messages may 
be sent. After the APL number is entered, the program prompts the user, prints a line 
of numbers to mark off seventy characters, and returns with a question mark. 


Any message shorter than nine seventy-character lines will be accepted. If 
only one line is being sent, a carriage RETURN is entered on the second question 
mark. 


NOTE: 


Comments or suggestions regarding the CANSIM Interactive System or data in CANSIM 
should be directed to APL number 116509702. 


EXAMPLE 35 
ie COMMAND ? MES 


TO APL NUMBER? 116509702 
MESSAGE(S) SHOULD BE NO LONGER THAN 9 70-CHARACTER LINES 
123456789. 123456789. 123456789. 123456789. 123456789.123456789. 123456789. 


? THIS IS A TEST MESSAGE 
9) 
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APPENDIX A 


CANSIM INTERACTIVE SYSTEM ERROR MESSAGES 


"DATE SHOULD BE 6 NUMERIC DIGITS" - The user is attempting to use an alphabetic or a 
special character for the start or end date option; the only valid characters are 
numerics. 


"DATE SHOULD HAVE FORMAT YYMMDD" - When retrieving the CANSIM NEWSFLASH the start and 
end date must be specified in the format YYMMDD, i.e. year, month, day. 


"DATE SHOULD HAVE FORMAT YYMMDD OR *"' - Only two, four, or six numeric characters or 
Ole asterisk are valid for this option. 


"DATE INVALID. TRY AGAIN." - The date for the GNP Command must be in the format 
YY (year) when only one year is required or YY-YY when more than one year is required. 


"DD (IN YYMMDD) FIELD INVALID" - The DD (day) field of the start or end date can only 
contain numeric characters from Ol to 31. 


"END DATE MUST NOT BE LESS THAN START" - The user is attempting to use an end date 
which is not greater than or equal to the start date which has been specified. 


"FIRST CHARACTER MUST BE ALPHABETIC" - When using the RENAME option, the first char- 
acter of the new name must be alphabetic. 


"TLLEGAL RESPONSE" - The user is entering a character which is not acceptable; read 
the question for the choice of valid responses. 


"INVALID DATABANK NUMBER - A valid Databank Number contains from two to eight char- 
acters the first of which must be alphabetic and all other characters must be nu- 
meric. 


"INVALID FORMAT. TRY AGAIN." - National Accounts Tables can be retrieved (using the 
GNP Command) by entering the desired table numbers separated by blanks or commas. 


"INVALID ** REQUEST IGNORED**" - The user is entering an invalid field with the 
NO PROMPT option. 


"INVALID TABLE NUMBER" - The user is entering an incorrect table number with the 
GNP and/or CEA Command. Check appendices G and I for the correct table numbers. 


~408 = 


"INVALID USE OF EQUAL SIGN" - The equal sign can only be used with the NO PROMPT and 
it must precede a variable name which is stored in the user's APL library. 


"JOB FOR THIS NUMBER FAILED" - Because of a system problem, the job has failed. 
There is no data retrieved nor are there any error messages; the job must be resub- 
mitted. 


"JOB NOT YET FINISHED" - The user is attempting to output a retrieval which has not 
yet finished execution; the STATUS command will indicate when the job has finished. 


"JOB TABLE FULL" - The user can have a maximum of 25 jobs (under one APL number) in 
the system at one time; either output the data using PHASE 2 or use the SCRATCH 
command to delete the data sets. 


"LIMIT MUST BE 4 DIGITS MAX" - When specifying the limit with the ALL option, the 
limit can be no greater than four numeric digits. 


"MATRIX NO., MAX LENGTH IS 6" - A valid matrix number is one to six numbers; consult 
the CANSIM Main Base Series Directory for valid matrix numbers. 


"MATRIX NO. SHOULD BE NUMERIC" - A valid matrix number contains neither alphabetic 
nor special characters; consult the CANSIM Main Base Series Directory for valid 
matrix numbers. 


"MAX. 8 CHARACTERS" - When using the RENAME option, the new name can contain a maxi- 
mum of eight characters. 


"MM ( IN YYMMDD) FIELD INVALID" - The MM (month) field of the start or end date can 
only contain numeric characters from 01 to 12. 


"NO DATA AVAILABLE" - No data has been retrieved; check the CANSIM Retrieval Error 
Messages. 


"NO ERRORS DETECTED" - The retrieval contains all the data as specified by the user. 


"NO JOB IN THE SYSTEM" - The user receives this message in response to the STATUS 
command when the user has no jobs in the system. 


"NO SPECIAL CHARACTERS ALLOWED" - When using the RENAME option, the new name cannot 
contain special characters. 


"NOT IMPLEMENTED" - The user is attempting to use a command other than one of the 
nine which are valid. 


"REQUEST NUMBER MUST BE 2 NUMERIC DIGITS" - The user is attempting to use alphabetic 
or special characters; only 2 numeric characters are permitted. 


"SERIES MUST NOT EXCEED 20 CHARACTERS" - Valid series numbers contain from one to 


twenty characters; consult the CANSIM Main Base Series Directory for valid series 
numbers. 


"SERIES NOT IN PROPER FORMAT" - Valid series numbers contain from one to twenty 
characters the first and last of which must be numeric. No alphabetic characters 
are allowed; the only special character acceptable is the period. Consult the 


CANSIM Main Base Series Directory for Valid Series numbers. 


"THIS APL NUMBER IS NOT REGISTERED" - An unregistered user is attempting to sign on 
to CIS, or a user is attempting to send a message to an APL number which is not an 
authorized CIS user. To have your APL number authorized to access CANSIM, contact 
CANSIM Staff at (613)995-7406. 


"THIS NUMBER IS NOT IN THE SYSTEM" - In PHASE 2, the user is attempting to output a 
Request Data Number which is not in the system. Use the STATUS command to obtain a 
dist of jobs currently in the system. 


"THIS REMOTE NOT AVAILABLE FOR YOUR APL NO." - When an APL number is authorized to 
retrieve data from CANSIM, valid remote stations are also assigned. The user is 
attempting to use a remote station which has not been assigned. To have your list of 
valid remote stations changed, contact CANSIM Staff at (613) 995-7406. 


"WORKSPACE FULL" - There is insufficient space in the APL workspace to store all the 
data retrieved. 
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APPENDIX B 


CANSIM RETRIEVAL ERROR MESSAGES 


When a job is submitted and the retrieved data is not exactly what was re- 
quested, the system gives the user the option of printing any messages which the 
system has generated. If the output is exactly what was requested, no messages are 
generated. 


For example, the user requests five time series starting in January, 1960. Of 
the five series requested, the earliest date available for one of the series is 
January, 1961. The system will retrieve four series starting in January, 1960, and 
the fifth series starting in January, 1961. In addition, the user has the option to 
print the error message which will read: 


"'00005G 000655 i Ro LARIAT 
INCOMPATIBLE, SUBSTITUTING DATE 610100". 


The "00005G" indicates that it is the fifth series requested; the "000655 1" is the 
CANSEM” Identification’ Number of the series, i:e.°matrix 655 series 1. “A list of 
messages follows: 


"JOB TERMINATED - SYSTEM ERROR' - Save all printouts associated with the run and 
contact the CANSIM Staff, Statistics Canada, at (613) 995-7406. 


"R - END DATE INCOMPATIBLE, SUBSTITUTING DATE------- ' - The supplied end date does 
not match any reference date for this series. Retrieve the CANSIM NEWSFLASH for in- 
formation on the latest data available or check with the source (see Inquiries List). 


"R - FROM MASSAGER NUMBER NOT ON BASE' - The first Databank number in range speci- 
fied could not be found on the CANSIM base. Check the CANSIM Main Base Series 
Directory for valid Databank numbers. 


"R - FROM SERIES NOT IN MATRIX' - The series number specified in the FROM series 
number field could not be found in the matrix specified. Check the CANSIM Main 


Base Series Directory for valid series numbers. 


"R - INVALID SECURITY WORD, PUBLIC DATA ONLY RETRIEVED------- DATAPOINTS REPLACED BY 
ZERO/SEC' - The supplied security word is not correct. If the data is required, 
check with the responsible source (see Inquiries List) for the proper word. 


"R — MASSAGER NUMBER NOT ON BASE' —- The Databank number requested could not be found 
on the CANSIM base. Check the CANSIM Main Base Series Directory for valid Databank 
numbers. 


'R — MATRIX FROZEN, DATA NOT AVAILABLE TO USERS' - the matrix requested is temporar- 
ily not available. Retrieve the CANSIM NEWSFLASH or check with the data source (see 
Inquiries List) to find out when it will be released. 


= th = 


'R — MATRIX NOT ON BASE' - The matrix number specified could not be found on the 
CANSIM base. Check the CANSIM Main Base Series Directory for,.valid matrix numbers. 


'R - NO DATA IN SERIES' - The series header information has been entered on the base; 
however, no data is currently available. Check with CANSIM Staff, Statistics Canada 
at (613) 995-7406 for data availability. 


"R - NUMBER OF DATA POINTS EXCEEDS LIMIT' - The number of data points allowed by the 
Databank format for one series exceeds 1200 in double precision or 2400 in single 
precision. 


"R - RANGE OF MASSAGER NUMBERS NOT ON BASE! - None of the Databank numbers in the 
range requested could be found on the CANSIM base. Check the CANSIM Main Base Series 
Directory LOE valid Databank numbers. 


"R - REPORT FREQUENCY NOT COMPATIBLE WITH MASSAGER' - The MASSAGER format permits 
only Annual, Quarterly, Monthly or Weekly series to be retrieved. If an attempt is 
made to retrieve a series with another frequency, the request is ignored and this 
message printed out. 


"R - SERIES FROZEN, DATA NOT AVAILABLE TO USERS' - the series requested is temporar- 
ily not available. Retrieve the CANSIM NEWSFLASH or check with the data source (see 
Inquiries List) to find out when it will be released. 


"R - SERIES NOT IN MATRIX' - The series number specified could not be found in the 
matrix specified. Check the CANSIM Main Base Series Directory for valid series 
numbers. 


"R - START DATE INCOMPATIBLE, SUBSTITUTING DATE------- ' - The supplied start date 
does not match any reference date for this series. Check the CANSIM Main Base 
series Directory fon valid stagt wdate. 


"R — START-END DATE OUT OF RANGE, NO DATA RETRIEVED' - The supplied start-end dates 
are either both prior to or both after the period of data available for this series: 


Check the CANSIM Main Base Series Directory for,.the startadate: 


"R - TO MASSAGER NUMBER NOT ON BASE' - The last Databank number in range specified 
could not be found on the CANSIM base. Check the CANSIM Main Base Series Directory 
for valid Databank numbers. 


"R - TO SERIES NOT IN MATRIX' - The series number specified in the TO series number 
field could not be found in the matrix specified. Check the CANSIM Main Base Series 
Directory for valid series numbers. 


"W - ALL SERIES NOT RETRIEVED. LIMITED TO NUMBER SPECIFIED' - When the ALL option 
is used, the number of series retrieved is limited to quantity specified. 


"W - HIGHER LEVEL DATA NOT RETRIEVED - ------- DATAPOINTS REPLACED BY ZERO/SEC' - The 


supplied security word or a blank was used in retrieving the datas} however data with 
a higher security level exists in this series. If the data is required, check with 


the responsible source (see Inquiries List) for the security word. 
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APPENDIX C 


CANSIM DATA RETRIEVAL 
DATE: MAR. 16 1977 PACE al 
000428 CONSUMER PRICE INDEXES FOR CANADA, 1971=100, MONTHLY, 


MATRIX NOTE 


AS OF AUGUST 1975, THE CPI VAS CONVERTED TO A 19712100 TIME REFERENCE 
BASE, REPLACING THE BASE OF 19 

61=100 WHICH HAS BEEN IN EPPECT SINCE JANUARY 1969. THE WEIGHTING PAT? 
ERN OF THE CPI WAS REVISED EFF 


ECTIVE MAY 1973. FOR DETAILED FXYPLANATION OF CONCEPTS AND METHODS, CON 
LACT SOURCE. 


COLUMN 1 1 ALL-ITEMS 

COLUMN 2 11 POOD 

COLUMN 3 see eee FOOD FOP HOME CONSUMPTION 

COLUMN 4 sas Beye oa DAIRY PRODUCTS INCLUDING BUTTER 

CANSIM DATA RETRIEVAL 
DATE: MAR. 16 1977 PAGE 2 

Se COLUMN(41 == =< COLUMN 2 ---'U-<=—eCOLUMN 3 --2 = COLUMN & <= 
DATE INDEX NO. FOOT INDEX NO. FOOT INDEX NO. FOOT INDEX NO. FOO? 
YYMMDD UNITS NOTE UNITS NOTE UNITS NOTE UNITS NOTE 
760100 145.1 166.8 165.7 168.5 
760200 145.6 166.3 164.9 16822 
760300 146.2 165.1 163.4 168.7 
760400 146.8 164.5 162.5 168.8 
760500 148.0 167.0 165.3 17030 
760600 148.7 167.3 165.5 171.0 
760700 149.3 167.8 165.8 1748 
760800 150.0 166.9 164.6 172.3 
760900 150.7 165.8 4 Bite. 1 7s 
761000 hs 165.8 163.0 1738 
761100 150.2 165.4 162.3 6.4 
761200 152.7 166.0 162.6 176.8 
770100 154.0 168.0 164.9 eee 
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